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Introduction 
Correios offers free, for contract clients, a set of services accessible via Web Services that 
allows the integration of client's systems with the technological environment of Correios. 
This manual describes the Web Services methods of the SIGEP Web application, which 
provides to clients the management of their posts, enabling: 

= Organization and registration of objects in a single interface that is integrated to 

Correios; 

= Search for services available on the postage card; 

= Check of contract status and postage card; 

= Objects registration codes anticipation even before posting; 

= Previous generation of object's list for postage control; 

= Access to informations, such as: tracking, ZIP Code query, services coverage, 


billing preview in D+1 — date plus one. 


1. Prerequisites 

In order to integrate systems with SIGEP Web Services, the customer needs to have a 
contract with Correios. 

In this case, you can ask to the commercial consultant for access authorization (username 


and password) for the contract and postage card (same CNPJ). 


2. Integration Process 

In the proposed vision here, the integration process involves Correios and the Client in five 

steps: 

1. Initialization: 

In this step, first the client's system performs a query to verify and/or validate the 
postage card status and available services. This action can be performed, for 
example, once a day; thus, it avoids that the objects are sent to a service that does 
not exist in the contract or with a pending cadastral situation. 
After validating the contractual situation and obtaining the contract and postage card 
details, labels range may be ordered. This functionality, “Request labels”, will always 


return a range of numbers according to the requested quantity. The numbers of 
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obtained registers will identify the objects that will be posted at Correios, and must 
be used to accompany the tracking. 
The client's system must locally manage a reservation range of order registration 
numbers, which will be consumed over a predefined period. This is a 
recommendation of good practices for developing the solution proposed here, 
however, there are no technical impediments to requesting the registration number 
per order. 

2. Order Fulfillment: 
It includes the minimum steps for the physical preparation of orders by the client. It 
allows the validation of price, delivery time, availability of the service to the destination 
ZIP code, in addition to selecting the best ways of delivery according to the necessity. 
The label to be printed must follow the standard proposed in this document, ANNEX 
01; 

3. Pre-posting: 
Closing of Pre-Posting List - PLP from previously fulfilled orders. These orders will be 
consolidated daily in a single list that will be electronically sent to Correios. The return 
will be a number that will identify the PLP. This number is the key for receiving orders 
at Correios and will be on the voucher, model in ANNEX 10 of this document. The 
control of shipment of orders will be through the voucher, generated by the client's 
system; 

4. Postage: 
Presents the steps for posting parcels at Correios; 

5. Accompaniment: 
This step corresponds to the management of sent and posted parcels at Correios. 
In addition to obtain the tracking number of these parcels in the postal flow until 
the moment of its delivery, it will be possible to obtain the updated data from 
admeasurement and uptake of the service and the value priced in Correios service 
system, for each order. 
Another functionality available at this stage is the suspension of delivery from an 
already posted parcel, as set outin ANNEX 12. 

The flow with the overview of the integration process can be found in ANNEX 11 of this 
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guide. 
3. SIGEP Web Web Services 

For integration with SIGEP Web Services, SOAP (Simple Object Access Protocol) 
and XML (eXended Markup Language) standards are adopted. 


3.1 Development and Homologation Environment 

After development, the client must carry out the integration tests of his system with Correios 
platform. There is an environment available for the development and homologation of 
integration from the client's system with the SIGEP Web Services, where an interface must 
be consulted and configured at the following address: 


https://apphom.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl 
The table below shows the information required for authentication and testing in the 


development and homologation environment. 


User Password Administrative Contract SE Postage Card CNPJ 
Code Number 
sigep n5f9t8 17000190 9992157880 10 0067599079 34028316000103 


*** For development and homologation, service codes must be consulted using the 


method buscaCliente(). 


When the tests are finished the client must forward the XML, the PLP and the 


labels to the responsible person for the contract at Correios for the respective 


validations. 





3.2 Production Environment 

For production, the parameters of the signed contract with Correios must be used, as well 
as the client and contract authentication data. 

For this environment, the Web Services interface must be consulted and configured at the 
following address: 
https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl 
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4. SIGEP Web — Web Services Methods 
This item describes the Web Services methods of the SIGEP Web application. 


In case of error in authentication of the methods, the client should contact the 


commercial consultant of Correios responsible for the contract. 





To facilitate the management of information, in ANNEX 09 of this document, there is a 
suggested table layout that the client can implement to store the data to be sent and received 
from SIGEP Web. 


4.1 Service availability between the Origin and Destination ZIP Code 


Through this method, it can be verified if a service that does not have national coverage is 
available between a CEP of Origin and Destination (Ex: Sedex, PAC, Sedex 10, Sedex 12, 
Sedex Large Formats and PAC Large Formats). 


a) Method Signature: 


verificaDisponibilidadeServico (codAdministrativo, numeroServico, cepOrigem, cepDestino, 


usuario, senha) 


b) Method Layout: 


ions “e 
contract with Correios. 
40215, 40290, 04162, 04669. 

as “e 
Example: 70002900. 


String (8) Destination ZIP code without hyphen Yes 
usuario String User login for authentication. (Provided | Yes 
by Correios Commercial Consultant 
upon request letter.) 
senha String Authentication password. (Provided by Yes 
Correios Commercial Consultant upon 
request letter) 
Correios Business Directorate - Department of Digital Channels 
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c) Method Return: 





String - “código do erro#motivo” (“error codettreason") 


d) Example: 


Service query between origin and destination zip code with valid return. 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
<cli:verificaDisponibilidadeServico> 
<codAdministrativo>17000190</codAdministrativo> 
<numeroServico>04162</numeroServico> 
<cepOrigem>05311900</cepOrigem> 
<cepDestino>05311900</cepDestino> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 
</cli:verificaDisponibilidadeServico> 
</soapenv:Body> 
</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2:verificaDisponibilidadeServicoResponse> 
<return>0#</return> 
</ns2:verificaDisponibilidadeServicoResponse> 
</S:Body> 
</S:Envelope> 


Service query between origin and destination zip code with invalid return.* 


<soapenv:Envelope> 
<soapenv:Header/> 
<soapenv:Body> 
<cli:verificaDisponibilidadeServico> 
<codAdministrativo>17000190</codAdministrativo> 
<numeroServico>04669</numeroServico> 
<cepOrigem>05311900</cepOrigem> 
<cepDestino>05311900</cepDestino> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 
</cli:verificaDisponibilidadeServico> 
</soapenv:Body> 
</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2:verificaDisponibilidadeServicoResponse> 
<return>008#Servico indisponível para o trecho informado.</return> 
</ns2:verificaDisponibilidadeServicoResponse> 
</S:Body> 
</S:Envelope> 





* Correios Web Services. 
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e) Codes and messages of return* 


0 | Successful processing 


*Reference: Correios Web Services. (Access to the manual - Annex 13) 





The “0” return is defined in SIGEP Web as a successful query. The other 
codes are mapped on Correios Web Services. 
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4.2 Available Services for Postage Card 

This method returns the available contract services for a specific postage card. 
a) Method Signature: 

buscaCliente (idContrato, idCartaoPostagem, usuario, senha ) 

b) Method Layout: 


lag ryt Description/N 


idContrato Contract number Ye o 
idCartaoPostagem Postage card linked to contract se 


Yes 
Yes 


usuario User login for authentication. (Provided 
by Correios Commercial Consultant 
upon request letter.) 

senha Authentication password. (Provided by 
Correios Commercial Consultant upon 
request letter) 


c) Example: 





Query: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
<cli:buscaCliente> 
<idContrato>9992157880</idContrato> 
<idCartaoPostagem>0067599079</idCartaoPostagem> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 
</cli:buscaCliente> 
</soapenv:Body> 
</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2:buscaClienteResponse> 
<return> 
<cnpj>34028316000103</cnpj> 
<contratos> 
<cartoesPostagem> 
<codigoAdministrativo>17000190</codigoAdministrativo> 
<numero>0067599079</numero> 
<servicos> 
<!-- Código do serviço, será utilizado no XML da PLP --> 
<codigo>04162</codigo> 
<descricao>SEDEX - CONTRATO</descricao> 
<!-- ID do serviço, será utilizado no método solicitaEtiquetas() --> 
<id>124849</id> 


</cartoesPostagem> 
<codigoDiretoria>10</codigoDiretoria> 
</contratos> 
</return> 
</ns2:buscaClienteResponse> 
</S:Body> 
</S:Envelope> 
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4.3 Address Query via ZIP Code 


This method returns the address corresponding to the informed ZIP code number. 
It is recommended to validate the address to avoid failures in the object forwarding. 


a) Method Signature: 
consultaCEP (cep) 


b) Method Layout: 


| | 





c) Example: 
Query: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
<cli:consultaCEP> 
<cep>70002900</cep> 
</cli:consultaCEP> 
</soapenv:Body> 
</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2:consultaCEPResponse> 
<return> 
<bairro>Asa Norte</bairro> 
<cep>70002900</cep> 
<cidade>Brasilia</cidade> 
<complemento/> 
<complemento2/> 
<end>SBN Ouadra 1 Bloco A</end> 
<id>0</id> 
<uf>DF</uf> 
</return> 
</ns2:consultaCEPResponse> 
</S:Body> 
</S:Envelope> 
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4.4 Postage Card Status 

This method returns the status of the postage card. Periodic research is recommended to 
avoid attempted postings with a suspended card, causing objects not to be accepted at 
Correios. 


a) Method Signature: 


getStatusCartaoPostagem (numeroCartaoPostagem, usuario, senha) 


b) Method Layour: 


<numeroCartaoPostagem> | String (1 Pt card number linked to 
contract 





<usuario> String User login for authentication. 
(Provided by Correios Commercial 
am upon request letter.) 
<senha> String Authentication password. ( EE 
by Correios Commercial Consultant 
upon request letter) 
c) Method Return: 


EF SJTUTTTTT === 
Normal / Cancelado (Normal/Canceled) 


d)Example: 
Query: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
<cli:getStatusCartaoPostagem> 
<numeroCartaoPostagem>0067599079</numeroCartaoPostagem> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 
</cli:getStatusCartaoPostagem> 
</soapenv: Body> 


</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2:getStatusCartaoPostagemResponse> 
<return>Normal</return> 
</ns2:getStatusCartaoPostagemResponse> 
</S:Body> 
</S:Envelope> 
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4.5 Requesting a Label Range for Posting 

This method returns a range of register codes, without check digits, for the objects postage. 
The registration code is also called the “number of register labels”. 

When preparing the order for postage, each label number must be used to generate the 
address label in the pattern mentioned in ANNEX 01 of this manual. 


This functionality will always return a range of labels, regardless of the quantity 


requested. If only one register is required, consider only the first number. 


The range of labels will be reserved for the informed CNPJ. 


It is recommended that the client's system manage this numerical range according to the 





used services, with a routine of control of stock labels. A range of labels may be requested 
according to the daily postage prediction separately by service, for example: PAC, Sedex 
etc. This process avoids high dependency between systems, reducing the number of 
requests. 


The returned number does not contain the check digit. To obtain this digit, the 
geraDigitoVerificadorEtiquetas method must be consumed or a routine for the 


calculation of the check digit must be implemented, according to the example in 
ANNEX 02. 





a) Method Signature: 


solicitaEtiquetas (tipoDestinatario, identificador, idServico, qtdEtiquetas, usuario, senha) 
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b) Method Layout: 


tipoDestinatario String (1) identification with the letter "C", of client 
Identificador String (14) CNPJ of the company, inform only numbers 


RE Long (6 Service Id, can be obtained in the method 
buscaCliente(). 


Allows to request 1 or “n” nf feaiater label numbers. 
User login for authentication. (Provided by 
Correios Commercial Consultant upon request 
letter.) 
senha String Authentication password. (Provided by Correios 
Fein A Commercial Consultant upon request letter) 


c) Method Return: 





<return> String (Labels Numbering Range). 
Note: The space between the number and BR corresponds 
to the position of the Check Digit of the label code (see 
example below). 





d) Example: 
Query: 


<soapenv:Envelope> 
<soapenv:Header/> 
<soapenv:Body> 
<cli:solicitaEtiquetas> 
<tipoDestinatario>C</tipoDestinatario> 
<identificador>*******</identificador> 
<idServico>124849</idServico> 
<gtdEtiguetas>1</gtdEtiguetas> 
<usuario>*******</usuario> 
<senha>*******</senha> 
</cli:solicitaEtiquetas> 


</soapenv: Body> 
</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2:solicitaEtiquetasResponse> 
<return>DL76023727 BR,DL76023727 BR</return> 
</ns2:solicitaEtiquetasResponse> 
</S:Body> 
</S:Envelope> 
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Attention! 


The tag or tracking number has 13 alpha-numeric digits, it's composed by: 
e Two initial letters that would be the postal type; 
e The 8 numbers + 1 check digit which is the postal type range; 


e And the final two letters that would be the identification of the country. 


The postal type is generally related to the service segment (express or standard), so it is 
important to understand that for each service there may be a postal type, if the services 


have the same segment, the system can issue the same postal type. 


In order for the system to understand which postal type is being requested, the information 
must be fetched in the buscaCliente method, in the <id> tag, and the data provided by the 
id is what will be informed in the method solicitaEtiquetas in the <idServiço> tag. In the 
table below is the example of postal types associated to the main service; it snows that to 
obtain a postal type, a specific id must be used and that is registered in the postage card. 





Example of postal types associated to the main service 




















Postal type Service Segment id 

OK SEDEX Contrato Agência Express 162XXX 
SEDEX Contrato Agência TA | Express 161XXX 

PX SEDEX Contrato Agência Standard 124XXX 
SEDEX Contrato Agência TA | Standard 123XXX 

















The postal types and service codes mentioned in the example, as well as their respective 
ids, are fictitious, since these informations are volatile. Thus, it is the developer's 
responsibility to understand that in a postage card can exist n services, and each service 
has its <id>. Each <id> is the reference value used to order the label. If you use an improper 
<id> and even then the system provides a label, only the postage system will refuse the 
order, being necessary redo the label. 
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4.6 Check Digit from Post Label Number 
This method returns the Check Digit of a label number or an array. The algorithm for 
generating the Check Digit is shown in the example in ANNEX 02 of this manual. 


a) Method Signature: 


geraDigitoVerificadorEtiquetas (etiquetas, usuario, senha) 


b) Method Layout: 


etiquetas String(13) You must enter a String. 
E.g.: “DL61145929 BR” 
In the empty space, between the 
number and BR, the check digit that is 
returned by the method must be 
recorded. It can be sent individually or 
as an array. 


usuario String User login for authentication. (Provided 
by Correios Commercial Consultant 
upon request letter) 

senha String Authentication password. (Provided by 
Correios Commercial Consultant upon 
request letter) 


c) Method Return: 
ma rban O————————————— 


<return> Int (Check Digit) Being an array, the return will be in the same 
order as the sequence of the label codes sent by the request. 


d) Example: 








Query: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
<cli:geraDigitoVerificadorEtiquetas> 
<etiquetas>DL74668653 BR</etiquetas> 


<etiquetas>DL76023727 BR</etiquetas> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 
</cli:geraDigitoVerificadorEtiquetas> 
</soapenv: Body> 
</soapenv:Envelope> 
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Return: 


<S:Envelope> 
<S: Body> 
<ns2:geraDigitoVerificadorEtiquetasResponse> 
<return>6</return> 
<return>2</return> 
</ns2:geraDigitoVerificadorEtiquetasResponse> 
</S:Body> 
</S:Envelope> 





4.7 Closing a Pre-Posting List of Objects 
This method allows to close a Pre-Posting List - PLP with the information from objects that 
will be posted. 


Before sending the objects from the list for posting the PLP must be closed. 


It is possible to close more than one PLP per day, depending on the client's needs. 


It is possible to send several objects from different services in the same PLP, limited to 
1000 (thousand) parcels per PLP. 





a) Method Signature: 


fechaPlpVariosServicos (xml, idPlpCliente, cartaoPostagem, listaEtiguetas, usuário, senha) 
b) Method Layout: 


xml String PLP (pre-posting list) in XML format. 
See specification from the PLP XML layout (see point “P 
of this item) and example in point “e” of this item 


idPlpCliente Long (10) Code generated by the client to identify the PLP 
e 


cartaoPostagem String (10) Postiage Card Number, which is the code that authorizes Yes 
posting services in the contract 


listaEtiquetas List<String> | List of objects sent via parameter without the check digit, | Yes 
for example: 
List <String> listaEtiquetas = new ArrayList <String> (); 
listaEtiquetas.add ( "DL12345677BR"); 
listaEtiquetas.add ( "DF12345678BR"); 
*** Remove the check digit and spaces, following the 
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same order as the objects sent in the xml parameter. 
Note: 1. The listaEtiquetas field is an array of constant 
objects in XML. The sequence of objects in the 
listaEtiquetas array should be the same as XML, which is 
also sent by parameter when starting the method. The 
objects reported in listaFtiquetas array must not contain 
the check digit. In XML, itis mandatory to inform the check 
digit of each label. 

2. The object codes should be obtained in advance by 
solicitaEtiquetas() method by service used. 





User login for authentication. (Provided by Correios 
Commercial Consultant upon request letter.) 

Authentication password. (Provided by Correios 
Commercial Consultant upon request letter) 


c) Method Return: 


Long (PI) - Numero da PLP (PLP numben 








d) Example: 
Query: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
<cli:fechaPlpVariosServicos> 

<xml></xml> <!-- Vide layout do XML da PLP --> 
<idPlpCliente>102030</idPlpCliente> 
<cartaoPostagem>0067599079</cartaoPostagem> 
<listaEtiquetas>DL76023727BR</listaEtiquetas> 
<listaEtiquetas>PH76023727BR</listaEtiquetas> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 


</cli:fechaPlpVariosServicos> 
</soapenv:Body> 
</soapenv:Envelope> 


Return: 


<S:Envelope> 
<S:Body> 
<ns2: fechaPlpResponse> 
<return>20563504</return> 
</ns2:fechaPlpResponse> 
</S:Body> 
</S:Envelope> 





e) fechaPlpVariosServicos() Method Code Example 


We transcribe a simple method of using the PLP method to close various services, using 
the PHP language. 


It can be adapted on any platform, following this example of a development environment. 
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<?php 
SclientSoap = new 
SoapClient ("https://apphom.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl") ; 


Sxml = “<?xml version=\"1.0\" encoding=\"ISO-8859- 
1V"?><correioslog><tipo arguivo>Postagem</tipo arguivo><versao arquivo>2.3</versao arquivo><plp><id . 
plp /><valor global 
/><mcu unidade postagem/><nome unidade postagem/><cartao postagem>0067599079</cartao postagem></plp> 
<remetente><numero contrato>9992157880</numero contrato><numero diretoria>10</numero diretoria><codi 
go administrativo>17000190</codigo administrativo><nome remetente><! [CDATA [Empresa 
Teste]]></nome remetente><logradouro remetente><! [CDATA [Avenida 
Central]]></logradouro remetente><numero remetente>2370</numero remetente><complemento remetente><![ 
CDATA[Sala 1205, 
12ºandar]]></complemento remetente><bairro remetente><! [CDATA [Centro]]></bairro remetente><cep remet 
ente>80002900</cep remetente><cidade remetente><! [CDATA [Curitiba] ]></cidade remetente><uf remetente> 
PR</uf remetente><telefone remetente><! [CDATA[4130795008]]></telefone remetente><fax remetente><! [CD 
ATA[4191239321]]></fax remetente><email remetente><! [CDATA[cli@mail.com.br]]></email remetente><celu 
lar remetente/> </remete 
nte><forma pagamento 
/><objeto postal><numero etiqueta>S0000641962BR</numero etiqueta><codigo objeto cliente/><codigo ser 
vico postagem>41068</codigo servico postagem><cubagem>0, 00</cubagem><peso>2500</peso><rt1/><rt2 /><re 
<destinatario><nome destinatario><! [CDATA[Cliente2]]></nome destinatario><telefone des 
tinatario><! [CDATA[6232339644]]></telefone destinatario><celular destinatario><! [CDATA[62991239321]] 
></celular destinatario><email destinatario><! [CDATA[cli2@mail.com.br]]></email_destinatario><lograd 
ouro destinatario><! [CDATA [Avenida 
Central2]]></logradouro destinatario><complemento destinatario><! [CDATA[Od: 102 A Lt: 
04]]></complemento destinatario><numero end destinatario>865</numero end destinatario><cpf cnpj dest 
</destinatario><nacional><bairro destinatario><! [CDATA[Setor 
Industrial]]></bairro destinatario><cidade destinatario><! [CDATA[Goiânia]]></cidade destinatario><uf 
_destinatario>GO</uf_destinatario><cep destinatario><! [CDATA[74503100]]></cep destinatario><codigo u 
suario postal/><centro custo cliente/><numero nota fiscal>112233</numero nota fiscal><serie nota fis 
cal/><valor nota fiscal/><natureza nota fiscal/><descricao objeto><![CDATA[]]></descricao objeto><va 
lor a cobrar>0,0</valor a cobrar></nacional><servico adicional><codigo servico adicional>025</codigo 
“servico adicional><codigo servico adicional>001</codigo servico adicional><codigo servico adicional 
>019</codigo servico adicional><valor declarado>3000,00</valor declarado></servico adicional><dimens 
ao objeto><tipo objeto>002</tipo objeto><dimensao altura>50, 00</dimensao altura><dimensao largura>30 
„00</dimensao largura><dimensao comprimento>60, 00</dimensao comprimento><dimensao diametro>0,00</dim 
ensao diametro></dimensao objeto><data postagem sara/><status processamento>0</status processamento> 
<numero comprovante postagem/><valor cobrado/></objeto postal><objeto postal><numero etiqueta>SL9992 
21795BR</numero etiqueta><codigo objeto cliente/><codigo servico postagem>40096</codigo servico post 
agem><cubagem>0, 00</cubagem><peso>800</peso><rt1/><rt2 /><restricao anac/><destinatario><nome destina 
tario><! [CDATA[Cliente3]]></nome destinatario><telefone destinatario><! [CDATA [6232339644] ]></telefon 
e destinatario><celular destinatario><! [CDATA[62991239333]]></celular destinatario><email destinatar 
io><! [CDATA[cli3êmail.com.br]]></email destinatario><logradouro destinatario><! [CDATA [Avenida 
Central3]]></logradouro destinatario><complemento destinatario><! [CDATA[Od: 102 A Lt: 
04]]></complemento destinatario><numero end destinatario>285</numero end destinatario> 
</destinatario><nacional><bairro destinatario><! [CDATA[Central]]></ 
bairro destinatario><cidade destinatario><! [CDATA[Goiânia]]></cidade destinatario><uf destinatario>G 
O</uf destinatario><cep destinatario><! [CDATA[74503100]]></cep destinatario><codigo usuario postal/> 
<centro custo cliente/><numero nota fiscal>224455</numero nota fiscal><serie nota fiscal/><valor not 
a fiscal/><natureza nota fiscal/><descricao objeto><! [CDATA[]]></descricao objeto><valor a cobrar>0, 
0</valor a cobrar></nacional><servico adicional><codigo servico adicional>025</codigo servico adicio 
nal><codigo servico adicional>001</codigo servico adicional><codigo servico adicional>019</codigo se 
rvico adicional><valor declarado>1000,00</valor declarado></servico adicional><dimensao objeto><tipo 
_objeto>002</tipo_ objeto><dimensao altura>40,00</dimensao altura><dimensao largura>50,00</dimensao 1 
argura><dimensao comprimento>30,00</dimensao comprimento><dimensao diametro>0</dimensao diametro></d 
imensao objeto><data postagem sara/><status processamento>0</status processamento><numero comprovant 
e postagem/><valor cobrado/></objeto postal></correioslog>”; 


SidPlpCliente = "102030"; 
ScartaoPostagem = "0067599079"; 
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/* 

Retirar o digito verificador dos objetos no array 

Seguir a mesma sequéncia do XML 

Remover os espaços dos objetos no parâmetro lista etiquetas 
rá 
SlistaEtiquetas = array ('S000064196BR', 'SL99922179BR'); 


Sparams = array ('xml' => Sxml, 'idPlpCliente' => SidPlpCliente, 'cartaoPostagem' => ŠcartaoPostagem, 


'listaEtiguetas' => SlistaEtiquetas, 'usuario' => 'sigep' , 'senha' => 'n5f9t8'); 
$result = SclientSoap->fechaPlpVariosServicos ($params) ; 

print r(Sresult); 

2 
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f) XML Layout Specification 


The layout is divided into the following tags: 


<?xml version="1.0" encoding="ISO-8859-1" ?> 





Correios standard encoding for xml. 
Note: required field 


<correioslog> 


It is the main tag. Note: required field 


<tipo_arquivo> 


This layout must be filled with the word Postagem 
Note: required field 


<versao_arquivo> 





Identifies the layout version of the XML file. This layout’s version is 2.3 
Note: required field 


Tag <plp> 


<id_plp> Identifies the register of the PLP - Pre-Posting | Numerical(11) The field must be empty, as it 
List that will be returned through the will be filled in by the return of 
closPlpVariosServicos method and will be this method 
the key to attendance at Correios from 
objects to be posted. 
It must be declared empty in XML, for 
example: <id_plp />. 
<valor_global> Value in reais of the total charging of PLP | Numerical(10,2) | The field must be empty, as it 
objects, which will be returned by the method will be filled in by the return of 
solicitaXmIPlp when posted. this method 
<mcu_unidade_postagem> Identifies Correios branch. Character(10) The field must be empty, as it 
will be filled in by the return of 
this method 


<nome_unidade_postagem> Correios branch name. Character(30) The field must be empty, as it 


will be filled in by the return of 
this method 


<cartao_postagem> Number of the client's postage card | Character(10) Mandatory filling 
associated with the PLP. Ex: 0067599079 
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Tag <remetente> 


Identifies the sender. This Tag must appear only once in the file. The necessary data 











for the sender are: 


<numero contrato> Contract number Character (10) Mandatory filling 


<numero diretoria> Number of the Regional Directorate from | Numerical (2) Mandatory filling 
clients contract, according to ANNEX 05 
<codigo administrativo> Contract administrative code Character (8) Mandatory filling 


<logradouro remetente> Sender address Character (50) Mandatory filling 


Recommended to use the consultaCEP () 
method 


Sender address number Character 
<complemento remetente> Sender address complement Character 
<bairro remetente> Sender district Character 


<cep remetente> Sender ZIP code Character 


~ 


5) Mandatory filling 
30) Not mandadory 
30) Mandatory filling 


8) Mandatory filling 
Format: 99999999 
There can be no space 


—| —| — 


or any character (e.g 
hyphen) between the 


numbers 


<cidade_remetente> Sender City name Character (30) Mandatory filling 
Sender State Character (2) Mandatory filling 


<telefone_remetente> Sender phone number Numerical (10) Not mandatory 
Format:99999999999, 
including DDD — area 


code (2 positions) + 
number. There can be 
no space or any 


character (e.g hyphen, 


parentheses, slash, 
plus sign) between 


numbers 
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<fax remetente> Numerical 10 Not mandatory 
Format:99999999999, 
including DDD — area 
code (2 positions) + 
number. There can be 
no space or any 
character (e.g hyphen, 
parentheses, slash, 
plus sign) between 
numbers 

<celular remetente> Sender cellphone number Numerical ( šu Not mandatory 
Format:99999999999, 
including DDD - area 
code (2 positions) + 
number. There can be 
no space or any 
character (e.g hyphen, 
parentheses, slash, 


plus sign) between 


numbers 





Tag <forma pagamento> 





Numeric value indicating the payment form used by the client to post. 
Note: The tag is mandatory. 

For billable posts, send the empty tag, for example: <forma pagamento /> 
See ANNEX 08 of this manual. 


Tag <objeto postal > 





Delimiting tag of the object to be posted. This tag contains the characteristics of the 


object. For postages of “n” objects, this tag must be repeated according to the quantity of 
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sent objects, limited to 1,000 objects per list. 


<numero etiqueta> Object code to be posted. Character (13) Mandatory filling 
Important: The code must include: 
Acronym of Postal Type (ex: DW) + 
object number + check digit + BR. 
Example: DW123456785BR 
Note: 1. It is mandatory to inform the 
check digit of each object code; 
2. The codes of the objects must be 
obtained previously by the method 
solicitaEtiquetas() by service used 


<codigo_objeto_cliente> Client tracking code Character (20) The field must be empty 


<codigo_servico_postagem> Service code to be used when posting | Character (5) Mandatory filling 
the object 
Note: The service code must match the 
postal type from the object register. E.g: 
04162, 04669 

<peso> Object weight S grams), the value to | Numerical (5 Mandatory filling 
be filled must be close to the weight of 
posting intention 


too Reserved for SIGEP Web The field must be empty 


"TE É 


+ | + <destinatario> || | Recipient data ||| | data o | Mandatory filling ||| filling 


Sec Relevant data to postage ae a Mandatory filling 
+ <servico ee Identifies the additional services from Mandatory filling 
the object ANNEX 06 


+ <dimensao_objeto> It must contain the dimensions of the Mandatory filling 


object (height, width, length and diameter) 
and the type of object (packaging) 


<data_postagem_sara> It must contain the effective date of the The field must be empty 
postage 


<status_processamento> Contains the STATUS of the object's | Character (1 Mandatory filling 
processing, information must be sent 


with a value equal to “O” 


<numero_comprovante_postagem> Contains the postage voucher number Numerical (10) The field must be empty 
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<valor cobrado> Value that was tariffed in Correios | Numerical (10,2) The field must be empty 
Service System. 
Tag <destinatario> 


This tag contains the parcel destination data. 








<nome_destinatario> Recipient name Character (50) Mandatory filling 


<telefone_destinatario > Recipient phone number Numerical (10) Not mandatory 
Format:99999999999, 
including DDD - area 
code (2 positions) + 
number. There can be no 
space or any character 
(e.g hyphen, 
parentheses, slash, plus 
sign) between numbers 

<celular destinatario> Recipient cellphone number Numerical (12) Not mandatory 
Format:99999999999, 
including DDD - area 
code (2 positions) + 
number. There can be no 
space or any character 
(e.g hyphen, 
parentheses, slash, plus 
sign) between numbers 

<logradouro destinatario> Recipient address Character (50) Mandatory filling 

Recommended to use the consultaCEP () 
method 


<complemento destinatario> Recipient address complement Character (30) Not mandatory 


<numero end destinatario> Recipient address number Character (5) Mandatory filling 
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Tag <nacional> 








The <national> tag should be within the <objeto postal> tag and contain the specific 
attributes from a postage of national objects. 


<bairro destinatario> Recipient district Character (30) Mandatory filling 
<cidade destinatario> Recipient City Character (30) Mandatory filling 
i i (2) 
) 


<uf destinatario> Recipient State Character (2 Mandatory filling 


<cep destinatario> Recipient ZIP Code Character (8 Mandatory filling 
Format: 99999999 
There can be no space or any 
character (e.g hyphen) between 
the numbers E.g: 01020030 


Ronee 
Object description Character (20) 


<valor a cobrar > Amount to be charged from recipient Numerical (9,2) Mandatory for service in the 
modality to be charged 





Tag <servico_adicional> 








The <servico_adicional> tag must be within the <objeto_postal> and contains the 
following attributes: 


<codigo_servico_adicional> Additional service code Character (3) Mandatory filling 
The additional service "025", 
referring to the registration, must 


always be informed. 


In case the services posted by 
the client have other additional 
services, the codes of these 
additional services must also be 
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<valor declarado> 


<endereco vizinho> 


Additional insurance amount declared |Numerical (9,2) 


by the client 


Address to delivery to neighbor 


Tag <dimensão objeto> 


Character (30) 


informed, see ANNEX 06. 


If the additional service code is 
equal to "019" or "064", the field is 
mandatory, observing the tariff 
limits 

Additional service code 011, see 
ANNEX 15. 











The <dimensao objeto> tag must be within the <objeto postal> tag and contains the 


following attributes: 


<tipo objeto> 


<dimensao altura> 


<dimensao largura> 


<dimensao comprimento> 


<dimensao diametro> 


Contains the code for the type of | Character (3) 
object that was posted 
(packaging) 

001 - Envelope 

002 - Package / Box 

003 - Roll / Cylinder / Spherical 
Packaging height (in cm) Numerical 


(9,1) 


Numerical 
(9,1) 


Packaging width (in cm) 


Numerical 
(9,1) 


Packaging length (in cm) 


Numerical 
0(9,1) 


Packaging diameter (in cm) 
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Mandatory filling 

For 001 - Do not fill in the dimension tags 

For 002 - Fill in the tags: height, width and length 
For 003 - Fill in the tags: length and diameter 


For: 

<tipo objeto> = 001 fill with "0" 

<tipo objeto> = 002, mandatory 

<tipo objeto> = 003, complete with "0" 
For: 

<tipo objeto> = 001 fill with "0" 

<tipo objeto> = 002, mandatory 

<tipo objeto> = 003, complete with "0" 
For: 

<tipo objeto> = 001 fill with "0" 

<tipo objeto> = 002, mandatory 

<tipo objeto> = 003, mandatory 

For: 

<tipo objeto> = 001 fill with "0" 

<tipo objeto> = 002, mandatory 

<tipo objeto> = 003, mandatory 
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9) PLP XML Example 


<?xml version="1.0" encoding="ISO-8859-1" ?> 
<correioslog> 
<tipo arquivo>Postagem</tipo arquivo> 
<versao arquivo>2.3</versao arquivo> 


<plp> 

sampile M> 

<valor global /> 

<mcu unidade postagem/> 

<nome unidade postagem/> 

<cartao postagem>0067599079</cartao postagem> 
</plp> 
<remetente> 


<numero contrato>9992157880</numero contrato> 

<numero diretoria>10</numero diretoria> 

<codigo administrativo>17000190</codigo administrativo> 

<nome remetente><! [CDATA [Empresa Teste] ]></nome remetente> 

<logradouro remetente><! [CDATA [Avenida Central]]></logradouro remetente> 
<numero remetente><! [CDATA [2370] ]></numero remetente> 

<complemento remetente><! [CDATA [Sala 1205, 12° andar] ]></complemento remetente> 
<bairro remetente><! [CDATA [Capão Raso]]></bairro remetente> 
<cep remetente><! [CDATA[81150050]]></cep remetente> 

<cidade remetente><! [CDATA [Curitiba] ]></cidade remetente> 

<uf remetente>PR</uf remetente> 

<telefone remetente><! [CDATA [4133332222] ]></telefone remetente> 
<fax remetente><! [CDATA[]]></fax remetente> 

<email remetente><! [CDATA [testefemail.com]]></email remetente> 

















<cpf cnpj remetente>12345678901234</cpf cnpj remetente> 


</remetente> 
<forma pagamento /> 
<!-- Se a lista contem mais de um objeto, a tag <objeto postal> deverá ser repetida ==> 
<objeto postal> 
<numero etiqueta>PH185560916BR</numero etiqueta> 
<codigo objeto cliente/> 
<codigo servico postagem>04669</codigo servico postagem> 
<cubagem>0, 00</cubagem> 
<peso>2500</peso> 
EE 
Kee Dil > 
— <restricao anac/> 
<destinatario> 
<nome destinatario><! [CDATA [Fulano] ]></nome destinatario> 
<telefone destinatario><! [CDATA[6233332222]]></telefone destinatario> 
<celular destinatario><! [CDATA[61999991111]]></celular destinatario> 
<email destinatario><! [CDATA[]]></email destinatario> 
<logradouro destinatario><! [CDATA[Rua Central]]></logradouro destinatario> 
<complemento destinatario><! [CDATA[Qd: 102]]></complemento destinatario> 
<numero end destinatario><! [CDATA[8065] ]></numero end destinatario> 


</destinatario> 
<nacional> 
<bairro destinatario><! [CDATA[Setor Industrial]]></bairro destinatario> 
<cidade destinatario><! [CDATA [Goiânia] ]></cidade destinatario> 
<uf destinatario>GO</uf destinatario> 
<cep destinatario><![CDATA[74503100]]></cep destinatario> 
<codigo usuario postal/> 
<centro custo cliente/> 
<numero nota fiscal>1424</numero nota fiscal> 
<serie nota fiscal/> 
<valor nota fiscal/> 
<natureza nota fiscal/> 
<descricao objeto><! [CDATA[]]></descricao objeto> 
<valor a cobrar>0,0</valor a cobrar> 
</nacional> 
<!-- O serviço adicional 025 deverá ser informado --> 
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<servico adicional> 
<codigo servico adicional>025</codigo servico adicional> 
<codigo servico adicional>001</codigo servico adicional> 
<codigo servico adicional>019</codigo servico adicional> 
<valor declarado>200,00</valor declarado> 

</servico adicional> 

<dimensao objeto> 
<tipo objeto>002</tipo objeto> 
<dimensao altura>20,00</dimensao altura> 
<dimensao largura>15,00</dimensao largura> 
<dimensao comprimento>20,00</dimensao comprimento> 
<dimensao diametro>0,00</dimensao diametro> 

</dimensao objeto> 

<data postagem sara/> 

<status processamento>0</status processamento> 

<numero comprovante postagem/> 

<valor cobrado/> 

</objeto postal> 





</correioslog> 


h) Guidelines for building XML 


1. 


The XSD that performs the XML validation can be consulted in ANNEX 04 of this 


document and must necessarily validate the XML, before closing the PLP. 


. For each tag, there is a note, if the note informs the mandatory filling, it is important 


that the proprietary system validates that criterion. 

Use the <![CDATA[ ||> in the text fields, to avoid problems with special characters 
that can corrupt the xml (&,%,>, <, # etc.). 

When including the XML file in the method (fechaPlp ou fechaPlpVariosServicos), 
exclude line terminators, so that the file is transported in a linear manner. 

To send the XML in the fechaPlpVariosServicos or fechaPlp method, remove the 
check digit and spaces from the label code in the method signature. The same order 
of the labels in the parameter must also be followed, as sent in the XML. 

The contract data, administrative code and postage card must be previously 
registered and within the validity period. It is possible to check the status of the 
postage card using the getStatusCartaoPostagem() method and obtain all the 
services available on the card via the buscaCliente() method. This consultation is 
important to avoid errors when sending a postage list on a card that has already 
expired. 

The posted service must be associated with the postage card, information obtained 
through the buscaCliente() method. 

The tag number is mandatory. Only registered objects can be posted. Thus, the 
additional code number "025", referring to the additional service "Registration”, must 
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always be declared in the <codigo servico adicional> tag for each posted object. 

The labels used in the file must belong to the client and the acronym must be 
associated to the service that will be posted, information obtained through the method 
solicitaEtiquetas(). If in the XML the label informed is for the SEDEX service, the 
service code must also be related to this service, SEDEX. This service/code relation 


can be consulted through the buscaCliente() method. 


10. All TAGS must be declared in XML, even those that are not mandatory. If they 


11. 


have no content, they must be declared empty. 

The communication homologation between the clients proprietary system and 
Correios will occur as follows: a) The client will simulate, in the homologation 
environment, the elaboration of a PLP and the use of the fechaPlpVariosServicos 
method to obtain the PLP number; b) The client will send to the commercial consultant 
the PLP number returned by the fechaPlpVariosServicos method; c) The 
commercial consultant will carry out the capture test for this PLP in the Correios 
service/operational system and, if there is no error, the communication/homologation 
will be valid and the client will be able to start using the pre-postage services in a 
production environment. We recommend that the client, before querying the 
fechaPlpVariosServicos method, validates the XML using an XSD schema. 

XML validation is important to verify if the tags are in accordance to what was 
requested in this manual. However, it is just a way to reduce a possible error when 
posting. Schema will only validate whether the content of the tag is within what was 
requested in this manual, but it will not serve to validate whether the content is true 
or not. The XSD is available at: 


http://www.corporativo.correios.com.br/encomendas/sigepWeb/ or in ANNEX 04. 


12. There will be the need for homologation of address labels realizing a reading test by 


Correios sorting machines or at the service unit. For this, the client must print a label 
template for each service he intends to use and forward them to the commercial 
consultant, who will provide the approval. The address of the standard layout of the 
labels is shown in ANNEX 01. 


13. Correios label includes 2D coding (DataMatrix). The 2D layout is shown in ANNEX 


03. 
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14. From 08/01/2018, the tag rt2 went from “Reserved for client observation” to 


“Reserved for SIGEP Web’, this tag will be for ECT's (Correios) exclusive use. 
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4.8 Requesting XML from PLP (Pre-Posting List) 

This method returns the same XML of the PLP that was previously sent by the client at its 
closing, being updated when the objects are posted at Correios, with information verified in 
the following tags: 


| | 
Nuno 62) 


<peso> Packaging weight (in grams) Numeric (5) 


<status processamento> Contains the STATUS of the object's processing, when posted equal to | Character (1 
“4 


<numero_comprovante_postagem> Contains the postage voucher number from Correios Service system Numeric (10) 
Value that was priced in Correios Service System for the object Numeric (10,2) 





a) Method Signature: 


solicitaXmIPlp (idPlpMaster, usuario, senha) 


b) Method Layout: 


idPlpMaster PLP number (pre-posting list) 


usuario String User login for authentication. (Provided by Correios Yes 
Commercial Consultant) 

senha String Authentication password. (Provided by Correios Yes 
Commercial Consultant) 





c) Method Return: 






xmi 
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d) Example: 
Query: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 
sali: solacatalmiPlo> 
<idPlpMaster>11234567</idPlpMaster> 
<usuario>sigep</usuario> 
<senha>n5f9t8</senha> 
</cli: solicitaXmlPlp> 
</soapenv: Body> 
</soapenv: Envelope> 


Return: 
<return><! [CDATA [<?xml version="1.0" encoding="IS0-8859-1"2> 
<correioslog> 


<tipo arquivo>Postagem</tipo arquivo> 
<versao arquivo>2.3</versao arquivo> 
<plp> 
<id plp>24022403</id plp> 
<valor global>25.6</valor global> 
<mcu unidade postagem>18484</mcu unidade postagem> 
<nome unidade postagem>AC PRESIDENTE VARGAS</nome unidade postagem> 
<cartao postagem>0067599079</cartao postagem> 
</plp> 
<remetente> 
<numero contrato>991220855</numero contrato> 
<numero diretoria>50</numero diretoria> 
<codigo administrativo>17000190</codigo administrativo> 
<nome remetente><! [CDATA[Correios - SEAD/GETER]]]]>><! [CDATA[</nome remetente> 


<logradouro remetente><! [CDATA [Avenida Teste]]]]>><! [CDATA[</logradouro remetente> 


<numero remetente><! [CDATA[3077]]]]>><! [CDATA [</numero remetente> 


<complemento remetente><! [CDATA [15º Andar]]]]>><! [CDATA [</complemento remetente> 


<bairro remetente><! [CDATA [Cidade Nova]]]]>><! [CDATA[</bairro remetente> 
<cep remetente><! [CDATA[20210030]]]]>><! [CDATA[</cep remetente> 

<cidade remetente><! [CDATA[Rio de Janeiro]]]]>><! [CDATA[</cidade remetente> 
<uf remetente>RJ</uf remetente> 

<telefone remetente><! [CDATA[2112345678]]]]>><! [CDATA[</telefone remetente> 
<fax remetente/> 

<email remetente/> 





</remetente> 
<forma pagamento/> 
<objeto postal> 
<numero etiqueta>S0012345678BR</numero etiqueta> 
<codigo objeto cliente/> 
<codigo servico postagem>04162</codigo servico postagem> 
<cubagem>0, 00</cubagem> 
<peso>300</peso> 
Sel 
SE 


<destinatario> 


<nome destinatario><! [CDATA [Destinatário Teste]]]]>><! [CDATA[</nome destinatario> 


<telefone destinatario/> 
<celular destinatario/> 
<email destinatario/> 


<logradouro destinatario><! [CDATA[Rua Teste]]]]>><! [CDATA[</logradouro destinatario> 
<complemento destinatario><! [CDATA[Loja 123]]]]>><! [CDATA[</complemento destinatario> 
<numero end destinatario><! CDATA[345]]]]>><! [CDATA[</numero end destinatario> 


</destinatario> 
<nacional> 
<bairro destinatario><! [CDATA[Centro]]]]>><! [CDATA[</bairro destinatario> 
<cidade destinatario><! [CDATA[Rio de Janeiro]]]]>><! [CDATA[</cidade destinatario> 
<uf destinatario>RJ</uf destinatario> 
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<cep destinatario><! [CDATA[20210900]]]]>><! [CDATA[</cep destinatario> 
<codigo usuario postal/> 
<centro custo cliente/> 
<numero nota fiscal>0</numero nota fiscal> 
<serie nota fiscal/> 
<valor nota fiscal/> 
<natureza nota fiscal/> 
<descricao objeto/> 
<valor a cobrar>0,0</valor a cobrar> 
</nacional> 
<servico adicional> 
<codigo servico adicional>25</codigo servico adicional> 
<codigo servico adicional>1</codigo servico adicional> 
</servico adicional> 
<dimensao objeto> 
<tipo objeto>2</tipo objeto> 
<dimensao altura>10,00</dimensao altura> 
<dimensao largura>20, 00</dimensao largura> 
<dimensao comprimento>30, 00</dimensao comprimento> 
<dimensao diametro>0, 00</dimensao diametro> 
</dimensao objeto> 
<data captacao>13/06/2016 17:17:01</data captacao> 
<data postagem sara>20160613</data postagem sara> 
<status processamento>1</status processamento> 
<numero comprovante postagem>1234567980</numero comprovante postagem> 
<valor cobrado>25.6</valor cobrado> 
</objeto postal> 


</correioslog>]]> 


| </return> 
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4.9 Request for Suspension of Parcel Delivery to Recipient 

This method allows you to send a request to suspend the delivery of a parcel to the recipient. 
The parcel will receive a flag indicating that its delivery must be suspended and, once 
identified by the distribution unit, the order will be forwarded for return to the sender. Only 
the contract holder that generated the pre-posting list for that object will be able to carry out 


the suspension. Once you submit the request, it is not possible to cancel it. 


By using this method, the CONTRACTING PARTY agrees with the TERMS OF 
CONDITIONS FOR THE PROVISION OF NATIONAL PARCELS SERVICES, 


contained in Annex 12 of this manual. 





a) Method Signature: 


bloquearObjeto (numeroEtigueta, idPlp, tipoBloqueio, acao, usuario, senha) 


numeroEtiqueta String(13) Must enter a String. Yes 
E.gx: “PJ236077302BR” 

tipoBloqueio String(15) For the type of blocking it must be informed | Yes 
(FRAUDE BLOQUEIO) - Fraud 

acao String(22) Should be informed in the action field | Yes 
(DEVOLVIDO AO REMETENTE) - Return to sender 

usuario String User login for authentication. (Provided by Correios Yes 
Commercial Consultant) 

senha String Authentication password. (Provided by Correios Yes 
Commercial Consultant) 


b) Method Return: 





c) Example: 


Consulta: 


<soapenv: Envelope> 
<soapenv: Header/> 
<soapenv: Body> 


<cli:bloguearObjeto> 
EU Optional e ==>: 
<numeroEtiqueta>SG037892748BR</numeroEtiqueta> 
al- Goeie ls 
<idPlp>80790</idPlp> 
alegar orel p= 
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ANNEX 01 - Address Label: 


Address Label is the printed form that contains all the parcel information that will be 
entrusted to Correios. 


It contains the registration number for tracking (Register label number), data of the sender 
and recipient and information of contracted service. It must be affixed to the object 
packaging for its correct identification and, therefore, to allow its delivery. 


In addition, the standardization of this label is necessary to facilitate automated sorting of 
the parcel in the postal flow of Correios. 


For more details see the Correios” Technical Guide for Addressing Objects: 
http://www.correios.com.br/enviar-e-receber/precisa-de-ajuda/como-enderecar-cartas-e- 





encomendas/guia-tecnico-de-enderecamento-de-encomendas 


For letters: 
http://www.correios.com.br/enviar-e-receber/precisa-de-ajuda/como-enderecar-cartas-e- 





encomendas 
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ANNEX 02 - Check Digit Generation Algorithm 


Example of Algorithm in Java: 


/* Exemplo de 


cálculo do digito verificador em Java -~ 
pübilnes tatie 


String 


Ex: 


prefixo = numeroEtiqueta.substring(0, 2); 
String numero = numeroEtiqueta.substring(2, 10); 
String sufixo = numeroEtiqueta.substring(10).trim(); 
String retorno = numero; 
String dv; 
integer |] multiplicadores = (8, 6 4, 2, Er By Sy The 
Integer soma = 0; 
// Preenche número com 0 à esquerda 
if (numeroEtiqueta.length() < 12) { 

retorno = "Error..."; 
jelse if (numero.length() < 8 && numeroEtiqueta.length () 


String zeros = ""; 
int diferenca = 8 - numero.length(); 


for(int i=0; i<diferenca; 
zeros += "0"; 


abaan iol 


} 
retorno = zeros + numero; 


else{ 


retorno = numero.substring(0, 8); 


ona (lo de dão stare) af 


soma += new Integer(retorno.substring (i, 


nteger resto = soma % 11; 
if (resto == 0){ 
av = Tons 
else if(resto == 1)( 
dy — uot; 
else{ 
dv = new Integer(11 - resto) .toString(); 





retorno += dv; 


retorno = prefixo + retorno + sufixo; 
return retorno; 


(it+1))) 
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String geraEtiquetaComDigitoVerificador (String numeroEtiqueta) { 


"DLO7798661BR" 


* multiplicadores [i]; 





aif 


38 


o SIGEP Web - Correios Post Manager 


Correios Guide for Integration via Web Services 





ANNEX 03 - 2D Layout - Data Matrix 





Size: 32 x 32 


CHARACTERS 
Destination ZIP Code 


ZIP Code Complement 

Origin ZIP Code 

ZIP Code Complement 

Destination ZIP Code Validator 
Variable Data Identifier 

Label Number 

Additional Services (see table below) 


Postage Card 
Service Code 


Cluster Information 

Address Number 

Address Complement 

Declared Value 

DDD (Area Code) + Recipient Phone Number 
Latitude 

Longitude 

Pipe “|” 

Client Reservation 


ZIP Code Complement: 
Address Number 


E.g1: 00100 
E.g2: 01200 
E.g3: 00000 (When the information is “S/N”, “BR 101”, “KM 5”) 


Destination ZIP Code Validator: 

Sum of 8 digits from the destination ZIP Code: 

When the result is not a sum of multiples of 10, the result is subtracted from the sum of the 
multiple of 10, immediately higher than the result. 
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E.g: ZIP: 71010050 > 7+1+0+1+0+0+5+0=14 
Subtract 14 and 20. 
The ZIP Code validator for the example is 6. 


When the result of the sum is multiples of 10, it is subtracted by itself. 
E.g2: ZIP: 05311000 > 0+5+3+1+1+0+0+0=10 

Subtract 10 - 10. 

The ZIP Code validator for the example is 0. 


IDV - Variable Data Identifier: 
Identifier of the service that is being used. 


51 Parcel Registration with additional service 


81 Mailing Pouches Registration with additional service 





Additional Services: 

It is mandatory to inform the code 25 of additional service. For other positions, when you 
do not have the additional service, it must be filled in with 00. 

E.g1: 250102194957 - Has the following additional services: 25, 01, 02, 19, 49 and 57 
E.g2: 250102190000 - It has the following additional services: 25, 01, 02, 19. The other 
positions are filled with 00. 

E.g3: 250000000000 - When there is no additional service. 


Additional Service Code” Return Receipt 


017 Election 
019 National Declared Value Premium and Express 
021 Electronic Return Receipt 
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Cluster Information: (PLP group identifier number) 

E.g1. PLP: 101515 (In this PLP we have seven objects, being: Three objects of the 
grouping with identifier 01, Two objects without grouping and two objects of the grouping 
with identifier 02). 

Label PH297898690BR - Grouping 01 

Label PH297898709BR - Grouping 01 

Label PH297898712BR - Grouping 01 

Label PH297898712BR 

Label PH297898726BR 

Label PH297898730BR - Grouping 02 

Label PH297898743BR - Grouping 02 

NOTE: The grouped postage must occur when there is more than one volume for the 
same recipient / address in the PAC service and the numbering of the grouped objects will 
have labels in sequence. 


Street number: Address number. 


Address Complement: Additional address information 
E.g1: House #100 Blk 2 

E.g2: Apt 1000 

E.g3: BLK II APT 1000 


Declared Value: Integer. 
E.g: 00100 
E.g: 01000 
E.g: 10000 


DDD + Recipient Phone: Recipient's phone number 

E.g1: 011999253224 

E.g2: 000000000000 - When there is no information 

Latitude: Reserved for future implementation. Fill with -00.000000 


Longitude: Reserved for future implementation. Fill with -00.000000 
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ANNEX 04 - Validation of XML using XSD Schema 

The validation of the XML that will be placed inside the <xml> tag of the methods 
fechaPlp() or fechaPlpVariosServicos() is important to check if the tags are in accordance 
with what was requested in this manual. However, it is just a way to reduce a possible error 
at the time of posting. Schema will only validate if the content of the tag is within with what 
was requested in this manual, but it will not serve to validate if the content sent in the XML 
is valid. 

Download the XSD at: 


http://www.corporativo.correios.com.br/encomendas/sigepWeb/doc/SIGEPWEB VA 
LIDADOR XML V2.XSD 
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ANNEX 05 - Regional Directorate Code (tag <numero diretoria>) 


01 CS - Correios Sede 
03 SE - ACRE 
04 SE - ALAGOAS 

SE — AMAZONAS 


SE — BAHIA 


10 SE — BRASÍLIA 

2 
E 
18 SE — MARANHÃO 

20 SE - MINAS GERAIS 


SE - MATO GROSSO DO SUL 


24 SE - MATO GROSSO 
28 SE - PARA 
30 SE — PARAIBA 
32 SE — PERNAMBUCO 
34 SE — PIAUÍ 
36 SE — PARANA 
50 SE - RIO DE JANEIRO 
Se ROGRANDEDONORTE |] 
B 
65 SE — RORAIMA 
64 SE - RIO GRANDE DO SUL 


| SE - SANTA CATARINA 


70 SE — SERGIPE 


SE - SÃO PAULO INTERIOR SPI 


72 SE - SÃO PAULO SPM 


SE- TOCANTINS 
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ANNEX 06 - Additional Service Code 


The additional service codes are associated to the main service An example is 
SEDEX, that has mandatory and optional additional services. The following table shows the 
additional services related to the main service: 


Table - Example of association of additional services to the main service (SEDEX, PAC and others). 




















































































































Additional 
Service Service Acronym | Acronym Description Use 
Code 
001 AR Return Receipt Optional 
002 MP Restricting Delivery Optional 
SEDEX - CONTRACT and 011 EV Delivery to Neighbor Optional 
Premium Services 017 ELEICAO | Election Optional 
019 VD Declared Value Optional 
025 RR Registration Mandatory 
001 AR Return Receipt Optional 
002 MP Restricting Delivery Optional 
PAC - CONTRACT 011 EV Delivery to Neighbor Optional 
017 ELEICAO | Election Optional 
025 RR Registration Mandatory 
064 VD Declared Value Optional 
001 AR Return Receipt Optional 
002 MP Restricting Delivery Optional 
SEDEX/PAC CONTRACT 011 EV Delivery to Neighbor Optional 
LARGE FORMATS 019 VD Declared Value Optional 
025 RR Registration Mandatory 
057 GF Large Formats Mandatory 
001 AR Return Receipt Optional 
CORREIOS MINI SHIPMENTS | 025 RR Registration Mandatory 
065 VD Declared Value Optional 
002 MP Restricting Delivery Optional 
es iia eee 025 RR Registration Mandatory 
- SELO E SE 
035 VD Declared Value Optional 
001 AR Return Receipt Mandatory 
aa CHAN 002 MP Restricting Delivery Optional 
ETIQ 025 RR Registration Mandatory 
035 VD Declared Value Optional 
002 MP Restricting Delivery Optional 
alio Nas CHANC 021 E-AR Electronic Return Receipt Mandatory 
ETIQ 025 RR Registration Mandatory 
035 VD Declared Value Optional 
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Return Receipt 


002 MP Restricting Delivery 
EV Delivery to Neighbor 


017 Election - exclusive use during the Electoral period and should only 
be used by clients who aim to make posts related to the Elections 
and must use the registered letter, Sedex and PAC services. The 
description “Elections - art. 239 of Law 4.737/65 ” is necessary and 
must be printed on the label. This additional service will be used 
by ECT for analysis and monitoring purposes. 

Here is an example: 


art. 239 da lei 4.737765 





National Declared Value Premium and Express. See the rules at 
https://www.correios.com.br/enviar-e-receber/servicos-adicionais 


E-AR Electronic Return Receipt 
RR National Registry 


Registered Letter Declared Value. See the rules at 
https://www.correios.com.br/enviar-e-receber/servicos-adicionais 
057 GF Large Formats 


National Declared Value Standard. See the rules at 
https:/Awww.correios.com.br/enviar-e-receber/servicos-adicionais 


Correios Mini Envios (Mini Shipments) Declared Value. See the 
rules at https://www.correios.com.br/enviar-e-receber/servicos- 


002 
019 
021 
025 
035 
057 
064 
065 


adicionais 








The use of the additional service is important since the absence of the declaration 
of the additional service, if it is mandatory, is the retum of the parcel. Therefore, it is 


important to know the main service and the additional services. 
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Examples to be used in XML: 





Example 1 - Use without optional additional service: 
<servico adicional> 
<codigo servico adicional>025</codigo servico adicional> 
<valor declarado /> 


</servico adicional> 





Example 2 - Use with optional additional service, with AR, the developer should consult 
the model in the annex: 
<servico adicional> 
<codigo servico adicional>025</codigo servico adicional> 
<codigo servico adicional>001</codigo servico adicional> 
<valor declarado /> 


</servico adicional> 





Example 3 - Use with optional additional service, with VD for express service: 
<servico adicional> 
<codigo servico adicional>025</codigo servico adicional> 
<codigo servico adicional>019</codigo servico adicional> 
<valor declarado>500</valor declarado> 


</servico adicional> 
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ANNEX 07 - Services Category and Referral Symbols for Dispatch 























SEDEX Hoje 
Premium SEDEX 10 > 
SEDEX 12 
Express SEDEX EA 
Standard PAC © 
Economic Mini Envios L 
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ANNEX 08 - Formof Payment Code (tag <forma_pagamento>) 


Postal Order 
Postal Refund 


Exchange Contract 


CS me 
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ANNEX 09 - Example of Tables for Storage in Database 


To facilitate the management of the generated information from the integration with these 
Web Services, as a suggestion, we present a scheme of tables that the client can create 


in his system to store the data to be sent and received from the SIGEP Web Services. 







? iddiente INT 
? idPedido INT ? idServicosECT INT © cartaoPostagem VARCHAR(10) 
© notaFiscal VARCHAR(9) © codigoServicoECT VARCHAR(5) <> contrato VARCHAR(10) 
> © descricaoServicoECT VARCHAR(50) © enpj VARCHAR(14) 


> > 


* idPedido INT 

? idServicosECT INT 

> codigoObjetoECT VARCHAR(13) 
> See ay 


7 idServicosECT INT 
7 iddiente INT 





Data example from the proposed model: 


Tb Pedido 


idPedido notaFiscal 
1 123456789 





Tb Pedido Servico 








idPedido idServicosECT codigoObjetoECT 
1 124849 TE123456785AA 
1 124884 TE123456785AB 
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Tb Servicos ECT 























idServicosECT codigoServicoECT descricaoServicoECT 
124849 04162 SEDEX 
124884 04669 | PAC 
Tb Servicos Cliente 
idServicosECT idCliente 
124884 1 
Tb Cliente 
idCliente cartaoPostagem contrato cnpj 
1 0066000000 9912200000 70111999000101 
| 2 0066000001 9912200001 | 71111999000101 
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ANNEX 10 - Posting Voucher or Posting List and Return Receipt 

The client may choose to print the Voucher or Posting List to accompany the postal objects 
when there is a home collection or when he delivers them to the service unit and does not 
wait in person. For attendance in person at the service units he may present only the postal 


objects to complete the postage. 


1- Postage Voucher: 


It is the summary report of the quantity of objects in the PLP, as example: 


€P Correios EMPRESA BRASILEIRA DE CORREIOS E TELÉGRAFOS 


PRÉ - LISTA DE POSTAGEM - PLP - SIGEP WEB 
SIGEP WEB - Gerenciador de Postagens dos Correios NºPLP: 2509485 


Contrato: 9992157880 
Cliente: ECT 
Telefone de contato: 6199999999 


Email de contato: 
Quantidade de Objetos: Serviço: 
1 04162 - SEDEX CONTRATO AGENCIA 
Data de fechamento: 12/06/2018 Data da entrega: I I 


Assinatura / Matricula dos Correios 





1º via - Correios 


2º via - Cliente 


€P Correios EMPRESA BRASILEIRA DE CORREIOS E TELÉGRAFOS 


PRÉ - LISTA DE POSTAGEM - PLP - SIGEP WEB 
SIGEP WEB - Gerenciador de Postagens dos Correios NºPLP: 2509485 


Contrato: 9992157880 
Cliente: ECT 
Telefone de contato: 6199999999 


Email de contato: 


Quantidade de Objetos: Serviço: 


1 04162 - SEDEX CONTRATO AGENCIA 
Data de fechamento: 12/06/2018 Data da entrega: I I 


Assinatura / Matricula dos Correios 
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2- Postage List: 


It is the detailed report that contains all the postal objects of the PLP, as an example: 
A4 format - Portrait 


2 Correios EMPRESA BRASILEIRA DE CORREIOS E TELÉGRAFOS 





LISTA DE POSTAGEM 
N° da Lista: 2509485 Remetente: CS Correios Telefone: 6199999999 
Contrato: 9992157880 Cliente: ECT 
Cód Adm.: 17000190 Endereço: SBN Quadra 1 Bloco A, 0 - Asa Norte 
Cartão: 0067599079 Brasília/DF - CEP: 70002900 
N° do Objeto CEP Peso AR MP VD V. Declarado N. Fiscal Serviço 
SZ274654354BR 05311900 20 S NN R$ 0,00 0 04162 - SEDEX CONTRATO AGENCIA 


Destinatario: Correios DR SPM - Gerėncia 


Quantidade de Objetos: 1 Carimbo e Assinatura / Matrícula dos Correios 
Data de fechamento: 12/06/2018 


APRESENTAR ESTA LISTA EM CASO DE PEDIDO DE INFORMAÇÕES 
Estou ciente do disposto na cláusula terceira do contrato de prestação de Serviços. 


ASSINATURA DO REMETENTE 
Obs: 1º via Unidade de Postagem e 2º via Cliente 





Página: 1 de 1 
3- Return Receipt (AR): 
It is the form that ratifies the contracting of the additional service that allows the physical 


proof of receipt by the recipient. 


«2 Correios SIGEP RECEBMENTO CONTRATO. 9092157800 


DESTINATÁRIO: TENTATIVAS DE ENTREGA: UNIDADE DE ENTREGA 
Correios DR SPM - Gerência 


Rua Mergenthaler, 592, 592 
Vila Leopoldina 
05311900 São Paulo-SP 


Cole aqui 


SZ274654354BR 


| | | | ||) MOTIVO DE DEVOLUGAO: 


1 Mudou-se Recusado 


REMETENTE: CS Correios 
ENDEREÇO PARA DEVOLUÇÃO DO OBJETO: 


2 Endereço hsufcente Nãa Procurado RUBRICA E MATRÍCULA DO CARTEIRO 


SBN Quadra 1 Bloco A, 0 i 
12 Norte GPOE Teste Asa Norte à Näo Existe oNúmem Aiko 
70002900 Brasilia-DF ua 


Faleodo 


9 Oums 


ai TS 


ASSINATURA DO RECESEDOR DATA DE ENTREGA 
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ANNEX 11 - Integration Process Vision 


Macro view of the pre-postage process until the order is monitored in the postal flow of 



















Correios. 
; p Disponibiliza os dados 
Alo ep ay Regulariza ou refazuma de postagem e pode ser ® 
2 embala e etiqueta nova etiqueta e PLP consultado pelo método 
5 d solicitaXmiPlp | 
Š Intenção de Fim 
Postagem 
E 
a 
a 
Ss 
a 
[=] 
a 
Pee P Realiza a Postagem 
ê Faza conferência exaustiva 
=) 
z & PLP OK das encomendas 
8 
= Hš algum 
problema com a 
PLP/encomenda? 





To generate the Pre-posting list (PLP) the client must validate the data he is sending to 


Correios. In the next images, we show the processes for validating, sending and monitoring 


the objects. 
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Postage Card validation: 


Validação 
A validação deve ser 
realizada com 
frequencia diária, além 

g Cartšo Cancelado/ Contrato ou Cartão de verificar, deve-se 
verificar a situação do Inexistente Cancelado/Inexistente manter atualizado o 
banco de dados local 
com os serviços 
Iniciar Entrar em contato existentes no cartão de 


ae com o Assistente 
ostagem, 
Malidaçao Retorno do Comercial A 2 


Status 


cartão de postagem 





Buscar dados do Cartão 
de Postagem Retorno do Validação 
método concluída com 


buscaCliente sucesso 


o Mėtodo Mėtodo 
getStatusCartaoPostagem buscaCliente 


E 
ps 
a 
so 
3 
a 
o 
a 
L 
= 
o 
m 
= 
= 
L 
o 
o 
T 
o 
m 
a 
L- 
E 
L 
> 


Retorno XML, tags relevantes: cnpj, 
Retorno String: codigoAdministrativo, diretoria, 
Normal, codigo (codigo do serviço), 
Cancelado e descricao (descrição do serviço), id 
Cartão (ID do serviço, está como 
Inexistente, dependente da tag servicos), 
chancela (chancela está codificada 
base 64 e dependente da tag 
chancela) 


WS Correios 
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ZIP Code validation: 


Retorno do 
método 


Endereço 
consultaCEP 


A válido 


CEP Não XML de 


Enviar CEP 


A idacž encontrado / d 
Apės validação de Não endereço 


dados cadastrais informado 


validação do CEP 


Método 
ConsultaCEP 


Retorno sera String 


Checking the service availability: 





£ Retorno do mėtodo Serviço 
uestiona ao WS verificaDisponibilidadeServico disponível 
se O serviço d 
desejado está 
disponível para a 
Após validação de entrega 
dados cadastrais 


Erro Retorno 
encontrado válido 


Método 
verificaDisponibilidadeSerico 


Retorno será String 


Verifica Disponibilidade do Serviço 





u 
“—- 
[= 
2 
A 
e 
a 
= 
[=] 
o 
” 
= 
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Creating labels: 





Poderá solicitar 



















A etiqueta é 
composta por 
duas letras + 9 
dígitos + duas 













por duas letras + 8 
dígitos + duas 
letras. Sendo 
identificador é o CNPJ, 
idServico é o id obtido 
no método 
buscaCliente 



















deloun an 
etiquetas letras finais, Neste 
ù processo será . 
= definido o dígito Tem o método 
E verificador, próprio, para o 
bad š cálculo do dígito Etiqueta 
verificador? válida 
& ne Cálculo do 
Solicitar dígito 
etiquetas Erro, Correção vena dar 
P de al dos dados no 
Apės validação de método 
5 dados cadastrais 
T 
5 
g 
T 
a 
kz] 
o 
į 
5 Método — Método || 
solicitaEtiquetas geraDigitoVerificadorEtiguetas 
A 
8 
s P 
5 Retorno sera 
> sequencial, da faixa de 
= etiquetas, Composto 





It will be the client's responsibility to request the quantity of labels, so the use must be 


conscientious. Incorrect use may impair the consumption of other users from the pre- 


postage service. 
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Sending the Pre-Postage data: 


To send the pre-postage data, the method fechaPlpVariosServicos is used, this method 


enables the label in Correios systems allowing the postage. 


Enviando os dados de Pré-Postagem 








Cliente 


WS Correios 





finalizou 
corretamente? 


Aa 


Produzir o XML com q 
os dados de pré Não 
postagem 





Apės validação de 
endereçamento, 
serviço e etiqueta 





validar no XSD 






Erro na 
estrutura do 
XML 






Estrutura do 
XML ok? 


Q 


Método 


fechaPlpVariosServicos 


Retorno sera String 





Numero da Pré Lista 


de Postagem (PLP) 





The XSD validation process is only structural, that means, it does not validate if the sent 


data is correct, but only if the TAGs obey the formatting. The label or reports must be built 


by the client who is developing the application, following the standard recommended by 


Correios, which is the Technical Guide for Addressing Objects, see Annex 01. 
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Subprocess “Produce XML with pre-postage data” (previous image): 


This subprocess has the purpose of showing the assembly of the XML inside the PLP, 
remembering that the method fechaPlpVariosServicos is an XML that is sending other XML, 
so it is necessary to use CDATA inside the <xml> tag, such as: 

<xml><![CDATA[<?xml encoding="ISO-8859-1" 


</correioslog>]]></xml> 


version="1.0" ?><correioslog>... 


Inicia o xml <correioslog> 


1, Cartão de postagem; 


Preencher os dados do 


1, Endereço válido obtido pelo 
consultaCEP: 2, Telefone 
preenchido somente por 


2. Contrato; 3, Diretoria |... 


do Contrato; 4, Código 


Utilizar os dados válidos 
do cartão de postagem 


Administrativo, 


Quando faz a 
validação do 

buscaCliente, a 

| consulta retorna a tag 

com o código do 
serviço, ela é 

| representada pela tag 

| codigo (dependente 

de servicos) 


Definir qual o serviço 





Preencher os dados do 


destinatário e com 
endereço válido 7 


Definir o formato, 
dimensões e status do 
objeto 


Fim <obieto postal 
objeto 


Finalizar o xml 
</correioslog> 





remetente com o endereço 
válido pelo consultaCEP 


números 


Iniciar 
<objeto postal> 


Com os dados de 
endereçamento entre remetente 
e destinatário, com o método 
verificaDisponibilidadeDoServiço 
, poderá definir qualo tipo de 
serviço disponível e se há 
condições especiais para 
entrega 


Utilizar somente os 
serviços disponíveis. 


Definir qual a etiqueta 


| Neste ponto utilizar o retorno do 
solicitaEtiqueta, 


Preencher os serviços 
adicionais se houver, como 
ha registro ou etiqueta, 
deve conter o "025", 


Deve-se atentar ao uso da tag 
servico adicional, já que hátags 
E . | que necessitam de complmento 
| tal como o serviço adicional 
| 019/064 que necessitam da tag 
valor declarado 
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Post-postage process: 


solicitaXmIPLP method 


To consult the postage data, using the Xml PLP request method, it is possible to obtain the 


postage data. 


Inicio do 
método 
solicita*mIPLP 


> 
à 
- 
a 
E 
> 
L 
mm 
E 
E 
> 
E 
a 
a 
oS 
_— 
a 
o 
B 
A 
o 
a 
q 
t 
o 
a 
A 
g 
L 
o 
- 
a 


WS Correios 


Fim do 
método 
solicita*mIPLP 


Dados de postagem 
através do método 
solicitaxmIPLP 


Retorno do XML 
com os dados da 
postagem 


PLP sem dados de 
postagem 


Dados de 
postagem 


Verifica o 
número da PLP 


Existem os 
dados da PLP? 
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consultaSRO NEW method: 
Discontinued method. To carry out the search for registered parcels/letters utilize the 


Object Tracking System (Sistema de Rastreamento de Objetos - SRO) Web Services from 
Correios, allows a faster return. So the recommendation is to use the SRO WS. 


Retorno em XML dos 
dados do objeto 












Solicita ao SIGEP WEB a 
informação do 


) rastreamento da 
encomenda pelo mėtodo Retomo do ano 
Rastreamento do Rastro 
de 


encomendas 


cliente 





Verifica se a etiqueta e 
dados de acesso são 
validos 


Processo de pós- postagem (Rastreamento) 


WS Rastreamento 


Retorno da 
etiqueta/dados de 
acesso 

















To access the manual: http://www.correios.com.br/enviar-e-receber/precisa-de- 


ajuda/manual rastreamentoobjetosws.pdf 
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bloquearObjeto method: 


The blocking method will depend on the return of other systems. Therefore, if the parcel is 
posted correctly, the method will be able to signal the suspension of delivery successfully. 
















































Postagem ` Bloqueio de Objeto 
ic 
Suspensão não 
= | Intenção de é possível 
E Intenção de | bloqueio 
gs postagem l 
S | a 
Inicio ; Inicio Sinalização via 
l sistema foi um 
| sucesso 
I 
l 
1 
= l 
£ a | 
2 = | 
2 = Maca ir | Existe a PLP de 
ecebe a 
5 w | Postado? 
5 g Recebe a PLP dE Posto i 
Ed 44 l 
[=] TEAR, 
3 = Finaliza a | 
E Postagem | 
& T 
2 E | 
FA I 
£ | É 
Ra É) | 
a ~ Realiza a į 
2 postagem | 
E I 
z | 
2 
a | 
fi 
[ 
I 
8 | 
É I p 
E Informa a | Suspensão da entrega 
3 postagem ao | a pedido do 
5 cliente contratante 
A u 1 
e I Suspensão foi 
i um sucesso? 
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ANNEX 12 — Term of Conditions for the Provision of National Parcels 


Services 


When implementing and using the Web Services Requesting Suspension of Parcel Delivery 
to Recipient method, the contract holder with Correios agrees with all the provisions of the 
TERMS OF CONDITIONS FOR THE PROVISION OF NATIONAL PARCELS SERVICES, 
available at http://www.correios.com.br/logistica/contrate-os-correios/termos-e-anexos-dos- 
produtos-e-servicos-contratados . 
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ANNEX 13 - Price and Delivery Time Calculator 


Correios price and delivery time calculator is intended for clients who have a SEDEX 
and PAC contract, who need to calculate, in their environment and in a personalized way, 
the price and delivery time of a parcel. 


Refer to the manual: http://www.correios.com.br/enviar-e-receber/ferramentas/calculador- 





remoto-de-precos-e-prazos/pdf/manual-de-implementacao-do-calculo-remoto-de-precos-e-prazos 
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ANNEX 14 - Collect that the client is aware of the tags resticao anac and 
ciencia conteudo proibido 


The ciencia conteudo proibido tag has the purpose of collecting the client's acceptance 
that he is not pre-posting prohibited objects. 

This tag must be added to the sender structure in XML and must be filled every time a Pre- 
Posting List - PLP is generated. 

The tag is filled in with the “S” (Sim — Yes) content, which means that the sender is aware 
and also declares that he is aware of the prohibited and restricted objects list available on 
Correios website and that he is not posting prohibited parcels according to current 
legislation, including the prohibitions contained in Article 13 of Law 6538/78. 


Example: 


<remetente> 


<email_remetente><![CDATA[email@mail.com.br]]></email_remetente> 

<celular_remetente/> 

<cpf_cnpj_remetente/> 

<ciencia_conteudo_proibido>S</ciencia_conteudo_proibido> 
</remetente> 


The tag restricao_anac has the purpose of collecting the client's acceptance that he is 
obeying the rules of restricted objects postage. 

This tag must be added to the structure of the objeto_postal in the XML and must be filled 
every time a Pre-Posting List - PLP is generated. 

The tag is filled in with the “S” (Sim — Yes) content, which means that the sender is aware 
and also declares that he is aware of the prohibited and restricted objects list available on 
Correios website and that he is not posting prohibited parcels according to current 
legislation, including the prohibitions contained in Article 13 of Law 6538/78. 


Example: 


<objeto_postal> 
<numero etiqueta>XX123456789BR</numero etiqueta> 
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<codigo objeto cliente/> 

«codigo servico postagem>04162</codigo servico postagem> 
<cubagem>0,0000</cubagem> 

<peso>100</peso> 

<rt1/> 

<rt2/> 

<restricao anac>S</restricao anac> 

-<destinatario> 


</objeto_postal> 


The system should inform when closing the PLP: “I declare to know the list of prohibited 
and restricted objects available on Correios website and that | am not posting in 
Correios objects classified as prohibited by the current legislation, including the 
prohibitions contained in Art. Law no. 6538/78."' Adding the postal address stating 


where to find the list: http://www.correios.com.br/enviar-e-receber/encomendas/proibicoes- 
e-restricoes 


As in the example below: 


Restrição Postagem 





Á Declaro conhecer a lista de objetos proibidos e restritos disponível no site dos Correios e que não estou postando nos Correios objetos classificados como proibidos pela legislação vigente, incluindo as vedações constantes do Art. 13° da Lei no. 6538/78. 


https://www.correios.com.br/precisa-de-ajuda/proibicoes-e-restricoes 








1 This phraseology may change. 
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ANNEX 15: Delivery to Neighbor 


Delivery to Neighbor functionality allows the inclusion of an alternative delivery address in 
case of absence in the recipient's address. Its use is free and does not affect the number of 
delivery attempts defined for the contracted service. In order to use it, the sender must 
indicate on the label the description of the authorized neighbor address to receive the order, 
using the field “DELIVERY TO NEIGHBOR AUTHORIZED” and select the additional service 
011. 





The admitted neighboring addresses are those up to two houses to the 
right or left or immediately in front of the recipient's address. 


















[| If the Delivery to Neighbor functionality is selected, the additional 


Add in servico adicional, when using the additional service code 011: 


service Restricting Delivery should not be used. 











XML example: 
<servico adicional> 
<codigo servico adicional>025</codigo servico adicional> 
<codigo servico adicional>011</codigo servico adicional> 
<endereco vizinho><![CDATA[Entrega no vizinho]]></endereco vizinho> 


</servico adicional> 
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Example of how to apply to the address label: 


When the additional service 011 is selected, the title: “DELIVERY TO NEIGHBOR 


AUTHORIZED” must appear and below the address from neighbor who is authorized to 
receive the parcel. 


TL DURE CL EET UE RA MORO RO RR Iš B TREO MIA 
Nome Legível 





Documento: Rubrica: 


ENTREGA NO VIZINHO AUTORIZADA 


Rua 8, 2222 








When additional service 011 is not selected, the message “UNAUTHORIZED” should 
appear in the blank “Delivery to Neighbor” field. As an example below: 


Nome Legivel: 





Documento: Rubrica: 


ENTREGA NO VIZINHO | 





NÃO AUTORIZADA 
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